home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / hypertxt / msdos / hyprvx11 / finger < prev    next >
Encoding:
Text File  |  1990-11-04  |  9.3 KB  |  266 lines
  1. FINGER
  2.  
  3. Finger is a SHOW SYSTEM-like program (tells you who's logged in, etc.)
  4. that performs the following functions:
  5.  
  6.      o "Show System"-like output, showing personal name, location,
  7.      program etc., of all users currently logged in.
  8.  
  9.      o Detailed information about a specified user including the
  10.      contents of the user's FINGER.PLN file (if the user has one) and
  11.      the status of the user's mailbox. In addition, if the user is
  12.      logged in, the user's job(s) is(are) displayed.
  13.  
  14.      o Finger will look up the user ID of a person whose name you know.
  15.      There are variations on this: e.g. you can find the user ID's of
  16.      all users with first name Fred. The rule finger follows for the  
  17.      command "$ FINGER user" is:
  18.  
  19.           1) See if "user" is a valid Username (login ID). If so: use it.
  20.  
  21.           2) Match "user" against the list of personal names kept by the
  22.           system. Output all matches. This match can be to any part of
  23.           the name. Thus "Rich" will match both "Richard" and "Heinrich".
  24.  
  25.  
  26. FORMAT:        Locally:
  27.  
  28.                FINGER [user] [Qualifiers]
  29.  
  30.                over the network:
  31.  
  32.                FINGER [user] [@host[@host...]] [Qualifiers]
  33.  
  34. Qualifiers:    User
  35.  
  36.                Asking for a specific user gives you a list of all the active
  37.                jobs for that user, as well as plan and mail information if
  38.                available.
  39.  
  40.                A "user" can be specified in one of several ways:
  41.  
  42.           o   A local VAX/VMS user name, possibly with wildcards.
  43.                Examples: "FL$SMITH", "BE*", etc. 
  44.                Standard VMS wildcard conventions are observed, i.e. "*" 
  45.                matches any string, "%" matches any character.
  46.  
  47.           o   A local personal name or part thereof. All matches for all
  48.               matching users will be output.
  49.     
  50.           o   A "." (period) to finger yourself. (e.g. to check you mail box.)
  51.  
  52.           o   An ID on a foreign network host, e.g. CS2.FOO@CU20C or D0J@CMCCTE
  53.  
  54. See also "HELP Finger Plan" and "HELP Finger Mail"
  55.  
  56.               Network
  57.  
  58.               Finger can retrieve information from a remote host on the
  59.               network if that host supports finger.
  60.  
  61.               The host is specified by a host name, preceded by an atsign,
  62.               e.g. @CU20A. Standard VMS wildcards can be used on the the
  63.               hostname in which case the command will be sent to all
  64.               hosts in the database conforming to the pattern. Thus: 
  65.               FINGER  @CU* will do a Finger to all hosts with names beginning
  66.               with "CU".
  67.  
  68.               (An alternate form for specifying a node is with the double colon.
  69.               Thus the two commands are equivalent:
  70.  
  71.                  FINGER @FOO
  72.                  FINGER FOO::
  73.  
  74.                In parsing the command, Finger searches for "@" first and if it
  75.                cannot find this it searches for "::" )
  76.  
  77.                Several host names may be strung together to effect routing to
  78.                other networks, e.g.: SU-AI@CUCS20
  79.  
  80.                (Routing is done right to left)
  81.  
  82.                If you give a host name with no user, you will get a listing of
  83.                all the non-operator jobs at the specified site (providing it 
  84.                is connected and is able to provide Finger service). You may      
  85.                include trailing options for the foreign host; these are not      
  86.                parsed locally, they are simply sent to the designated host,      
  87.                which may or may not know what to do with them.  E.g. FINGER      
  88.                foo@unixa -a -b -c
  89.  
  90.                In all cases, the rightmost host name and its atsign are 
  91.                removed from your command and the rest of it is sent to that 
  92.                host as you typed it. Intermediate hosts do the same thing, 
  93.                until the command has no host names left, at which  point the 
  94.                host at which it has arrived executes the remainder of the        
  95.                command.
  96.  
  97.  
  98.                Plan
  99.  
  100.                If you "Finger" an individual user, personal information about
  101.                that user will be listed if it is available. A user should put
  102.                this information in a file named "FINGER.PLN" in his/her login
  103.                directory. Information such as phone number, office hours, etc.
  104.                may be appropriate.
  105.  
  106.  
  107.                Mail
  108.  
  109.                If you "Finger" an individual user, information about that
  110.                user's mailbox will be listed. This consists of the number of
  111.                new mail messages received since last read by the user, and 
  112.                whom they are from. This is useful to see if a person has read    
  113.                your mail yet etc.
  114.  
  115.  
  116.                /HELP
  117.  
  118.                Print this message.
  119.  
  120.                /INTERACTIVE
  121.                /INTERACTIVE (D)
  122.                /NOINTERACTIVE
  123.                
  124.                List interactive processes.
  125.  
  126.                /BATCH
  127.                /NOBATCH (D)
  128.  
  129.                List the batch Processes on the system.
  130.  
  131.                /SUBPROCESS
  132.                /NOSUBPROCESS (D)
  133.  
  134.                List subprocesses.
  135.  
  136.                /NETWORK
  137.                /NONETWORK (D)
  138.  
  139.                List network (DECnet) jobs.
  140.  
  141.                /SYSTEM
  142.                /NOSYSTEM (D)
  143.  
  144.                List system processes.
  145.  
  146.                /ALL
  147.  
  148.                List all processes, including system processes.
  149.  
  150.                     Note: /ALL selects all processes for display, whereas 
  151.                     /FULL specifies that all information for the selected        
  152.                     processes be displayed.
  153.  
  154.                /MESSAGE (D)
  155.                /NOMESSAGE
  156.  
  157.                Display the system message of the day with the output.
  158.  
  159.                /PROCESSNAME (D)
  160.                /NOPROCESSNAME
  161.  
  162.                Display the user's process name.
  163.                     Note: process name will be the same as the Username 
  164.                     (login ID) except for batch jobs and when the user is 
  165.                     logged in on more than one terminal.
  166.  
  167.                /PID
  168.                /NOPID (D)
  169.  
  170.                Display the user's process ID (PID).
  171.  
  172.                /USERNAME
  173.                /NOUSERNAME (D)
  174.  
  175.                Display the user's username (login ID). Note: process name
  176.                will be the same as the Username (login ID) except for batch 
  177.                jobs and when the user is logged in on more than one terminal.
  178.  
  179.                /PERSONALNAME (D)
  180.                /NOPERSONALNAME
  181.  
  182.                Display the user's personal name.
  183.  
  184.                /IMAGENAME (D)
  185.                /NOIMAGENAME
  186.  
  187.                Display the user's image (program) name. A "$" means the
  188.                user is at the DCL level.
  189.  
  190.                /TERMINAL
  191.                /NOTERMINAL (D)
  192.  
  193.                Display the terminal line number.
  194.  
  195.                /LOGINTIME (D)
  196.                /NOLOGINTIME
  197.  
  198.                Display the time the user logged in. Format is hh:mm.
  199.  
  200.                /CPUTIME
  201.                /NOCPUTIME (D)
  202.  
  203.                Display the amount of CPU time used. Format is mmm:ss  (or
  204.                mmmmmm for times over 999 minutes.)
  205.  
  206.  
  207.                /IDLETIME (D)
  208.                /NOIDLETIME
  209.  
  210.                Display the time since the last terminal activity if the system
  211.                is waiting for terminal input from the user. Format is hh:mm.
  212.                A single "." in the display means the terminal has been idle
  213.                for more than 1 second but less than 1 minute.
  214.  
  215.                /SIZE
  216.                /NOSIZE (D)
  217.      
  218.                Display the process working set size in pages. Includes both
  219.                process and global pages.
  220.      
  221.                /STATE
  222.                /NOSTATE (D)
  223.      
  224.                Display the process scheduling state.
  225.  
  226.                     Possible states are:
  227.      
  228.             Cur     Currently Executing Process
  229.             Com[O]  Computable
  230.             LEF[O]  Local Event Flag Wait
  231.             CEF     Common Event Flag Wait
  232.             MWait   Miscellaneous Wait, Mutex Wait, or Resource Wait
  233.             PFW     Page Fault Wait
  234.             Hib[O]  Hibernate Wait
  235.             Susp[O] Suspend Wait
  236.             ColPg   Collided Page Wait
  237.             FPg     Free Page Wait
  238.      
  239.                O suffix indicates outswapped.
  240.      
  241.                /LOCATION (D)
  242.                /NOLOCATION
  243.  
  244.                Display the location of the user's terminal for interactive
  245.                jobs.
  246.  
  247.                /TTType
  248.                /NOTTType (D)
  249.  
  250.                Display the type of terminal for interactive users.
  251.  
  252.                /Swapped
  253.                /NOSwapped(D)
  254.  
  255.                Displays Image name, Login time, and CPU time for out-swapped
  256.                processes. Normally these are not displayed since to do so
  257.                would require in-swapping the process.
  258.  
  259.                /FULL
  260.  
  261.                Displays all information for the selected processes. This 
  262.                display will overflow the screen width on most terminals.
  263.  
  264.                Note: /ALL selects all processes for display whereas /FULL
  265.                specifies that all information for the selected processes be
  266.                displayed.